home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / music / gmod211.zip / GUSMOD.DOC < prev    next >
Text File  |  1980-01-01  |  15KB  |  369 lines
  1. ┌───────────────────────────── Gusmod 2.11 ───────────────────────────────────┐
  2. │                               GTSR 1.11                                     │
  3. │                                                                             │
  4. │                            By Joshua Jensen                                 │
  5. │                      (CyberStrike of Renaissance)                           │
  6. │                        Copyright (C) 1992,1993                              │
  7. │                                                                             │
  8. │                     Release Date: March 13, 1993                            │
  9. ╘═════════════════════════════════════════════════════════════════════════════╛
  10.       "Gusmod" and "GTSR" are almost fully Protracker-compliant module players
  11. written to use the Gravis Ultrasound card from Advanced Gravis and Forte
  12. Technologies.  Most of the Protracker commands are implemented; most of them
  13. work under the new UltraClick Removal System.
  14.  
  15.       It is HIGHLY recommended that Gravis UltraSound owners upgrade their
  16. cards to a meg.  This seems to be a major problem with modules greater than
  17. 256k.  Besides, future games from Renaissance and other commercial companies
  18. will come to rely on that megabyte being there.
  19.  
  20.  
  21. ──────────────┐
  22. Gusmod Setup: │ The setup has NOT changed from v2.10.
  23. ──────────────┘
  24. Because of the Gusmod's and GTSR's capabilities, the setup of the player has
  25. become more complicated.  The end result makes a much nicer, easier to use
  26. system.
  27.  
  28. Add the following line to your AUTOEXEC.BAT:
  29.  
  30. SET GUSMOD=<PATH>
  31.  
  32. A GUSMOD environment variable which will set the system to look for Gusmod's
  33. files in the directory C:\GUSMOD would look like:
  34.  
  35. SET GUSMOD=C:\GUSMOD
  36.  
  37. Change to Gusmod's directory and run SETUP.EXE.  At this point, configure
  38. your system setting and then exit.
  39.  
  40. Gusmod requires four .INF files.  The first .INF file is named MUSIC.INF.
  41. These are the compressed, loadable music routines.  This particular version
  42. runs on a Gravis UltraSound only.  Future .INF files which replace the
  43. MUSIC.INF file will allow GUSMOD to work on a variety of soundcards.
  44.  
  45. The second .INF file is named SCOPES.INF.  This file contains the graphics
  46. screen for the oscilloscopes in GUSMOD.
  47.  
  48. The third .INF file is named GUSMOD.INF.  This is GUSMOD's configuration.
  49. This file is created and restored via the F1/F2 keys in Gusmod.
  50.  
  51. The fourth .INF file is named GTSR.INF.  This is GTSR's configuration.
  52. This file is created and restored via the F3/F4 keys in Gusmod.
  53.  
  54. Gusmod also requires a file called GSETUP.CFG, created with SETUP.EXE.
  55.  
  56. WARNING:  THE MUSIC.INF AND GSETUP.CFG FILES MUST BE PRESENT FOR GUSMOD TO
  57. EXECUTE PROPERLY!
  58.  
  59.  
  60. ──────────────────┐
  61. GTSR Information: │
  62. ──────────────────┘
  63. GTSR seems to only have a few minor bugs, of which none seem to do anything
  64. harmful to the system.
  65.  
  66. To use GTSR, you type at the DOS prompt:
  67.  
  68. d:\> GTSR module<.mod>
  69.  
  70. The .mod extension is not required.
  71.  
  72. The appropriate file will be loaded and played.  GTSR will exit to DOS.
  73.  
  74. To stop the music, just type GTSR at the command line.  The memory will be
  75. freed, and it will exit to DOS.
  76.  
  77. Example:
  78.  
  79. GTSR BEYOND.MOD
  80. GTSR FLETCH.MOD                 < Turns off BEYOND.MOD and runs FLETCH.MOD >
  81. GTSR                            < Turns off FLETCH.MOD >
  82.  
  83.  
  84. ─────────────────────────────────┐
  85. Gusmod Command Line Information: │
  86. ─────────────────────────────────┘
  87. To use Gusmod, you type at the DOS prompt:
  88.  
  89. d:\> GUSMOD <module<.mod>>
  90.  
  91. The .mod extension is not required.
  92.  
  93. If you want to run Gusmod in interactive mode, that is, have a file selection
  94. window, then type "GUSMOD" by itself.
  95.  
  96.  
  97. ────────────────┐
  98. The Grand Tour: │
  99. ────────────────┘
  100. After running Gusmod, you'll see a screen, as described below.
  101.  
  102. The first line indicates the version, release date, and memory used by the
  103. program.  The memory used is an approximation, and in almost all circumstances,
  104. there is more memory available.
  105.  
  106. Following that are the tracking lines.  The center, highlighted line is the
  107. current line being played.
  108.  
  109. The next section contains the following:  The current pattern/the number of
  110. patterns/the current sequence/the number of sequences/a local sequence list/
  111. the four available channels, toggled on or off/the max volume percentage.
  112.  
  113. The last section shows the current instrument being played, a VU meter, the
  114. pan position, and percentage of the max volume that the voice is playing.
  115.  
  116.  
  117. ───────────────────┐
  118. How to use Gusmod: │
  119. ───────────────────┘
  120.  
  121. The following keys are available for usage:
  122.  
  123.         ESC         - Quits Gusmod and returns to DOS.
  124.         1           - Toggles voice one on/off.
  125.         2           - Toggles voice two on/off.
  126.         3           - Toggles voice three on/off.
  127.         4           - Toggles voice four on/off.
  128.         -           - Decreases max volume.
  129.         =           - Increases max volume.
  130.         TAB         - Switches between scopes and text.
  131.         PgUp        - Jumps to previous pattern.
  132.         PgDn        - Jumps to next pattern.
  133.         Space       - Module looping on/off.
  134.         Up Arrow    - Moves channel selector up.
  135.         Down Arrow  - Moves channel selector down.
  136.         Left Arrow  - Moves pan position for current channel to the left.
  137.         Right Arrow - Moves pan position for current channel to the right.
  138.         [           - Decreases channel volume percentage.
  139.         ]           - Increases channel volume percentage.
  140.         F1          - Save the current mode (text or scopes), the pan
  141.                       positions, the master volume, the channel volumes,
  142.                       and the loop state for Gusmod.
  143.         F2          - Retrieve the information saved with F1.
  144.         F3          - Save the current mode (text or scopes), the pan
  145.                       positions, the master volume, the channel volumes,
  146.                       and the loop state for GTSR.
  147.         F4          - Retrieve the information saved with F3.
  148.  
  149. When a non-looping module is finished, pressing the space bar will restart
  150. it.  ESC will exit to DOS.
  151.  
  152.  
  153. ──────┐
  154. Bugs: │
  155. ──────┘
  156.   ■ Modules continuously loop even with looping off if there is a jump command
  157.     embedded.  This should be fixed later.
  158.   ■ Gusmod seems to not function with Adaptec SCSI devices.  ???
  159.  
  160.  
  161. ─────────┐
  162. Updates: │
  163. ─────────┘
  164. Version 2.01 ───────────────────────────────────────────────── February 13, 1993
  165.     ■ Module looping toggled with the space bar key.
  166.     ■ The "buzz" bug is toast!
  167.  
  168. Version 2.02 ───────────────────────────────────────────────── February 14, 1993
  169.     ■ The Number of patterns now displays correctly.
  170.     ■ More infamous Ultraclicks removed.
  171.     ■ Modules like Beyond Music play correctly.  Minor bug dealing with
  172.       "leftovers".
  173.     ■ Fixed the bug where there was an instrument, but not a note.
  174.     ■ Added configuration files.
  175.     ■ Added the new environment variable techniques.
  176.     ■ Added the ability to restart the module when not looping.
  177.  
  178. Version 2.03 ───────────────────────────────────────────────── February 15, 1993
  179.     ■ Tried to get even more clicking out.
  180.     ■ Extra environment variable commands.
  181.     ■ Fixed IRQ stuff.
  182.     ■ Two config files, one for Gusmod, one for GTSR.
  183.     ■ There were some hard coded 220h's in the code.  These aren't hard coded
  184.       anymore.  Sorry, everyone.  It should not hang anymore.
  185.  
  186. GTSR 1.02 ──────────────────────────────────────────────────── February 15, 1993
  187.     ■ GTSR now properly frees itself from memory (I forgot to free the
  188.       environment block!).  Check it out!  Type MEM /C out the DOS prompt
  189.       before and after.
  190.  
  191. Version 2.04 ───────────────────────────────────────────────── February 15, 1993
  192.     ■ Finally, everything now works!  Stupid DMA In and Out!
  193.     ■ The kill-those-darn-playing bugs release.
  194.     ■ Looping now works properly.
  195.     ■ Loop pops are history!
  196.     ■ Hardly any pops (they're all sample now).
  197.     ■ Things like the bassdrum in Axel F now play correctly.
  198.     ■ Retrig Note works!
  199.     ■ Note Cut works!
  200.     ■ Note Delay works!
  201.     ■ Added a new note table for more accurate frequencies.
  202.     ■ The scopes now work correctly!
  203.  
  204. Version 2.10 ───────────────────────────────────────────────────── March 7, 1993
  205.     ■ Looping really does work properly now. :)  (or so we think!)
  206.     ■ Loop pops are now really history!  It was a bug on crossing DRAM page
  207.       bounds.
  208.     ■ Still some interesting sample pops, but...
  209.     ■ Retrig really does work now.
  210.     ■ Gusmod now properly frees itself from the GF1 IRQ.
  211.     ■ 15 and 31 instrument .MODs are supported.
  212.     ■ Older versions of Gusmod (including 1.1) were allocating 4,096 bytes
  213.       for each pattern instead of the required 1,024 bytes.  This has been
  214.       remedied.
  215.     ■ 16-channel support added!
  216.     ■ 5-octaves supported!
  217.     ■ Tuning for 5 octaves is approximate, but normally sounds pretty good.
  218.     ■ Mods are now converted into a PS16 file format.  This format is the
  219.       packed 16-channel format for Protracker Studio 16 and Gusmod 2.10+.
  220.     ■ Note frequency table deleted for a supposedly "working" algorithm.
  221.     ■ Volumes that are 1 now work.
  222.     ■ Volumes are now a bit more "linear."
  223.     ■ GTSR now loops properly.
  224.  
  225. Version 2.11 ──────────────────────────────────────────────────── March 13, 1993
  226.     ■ The "buzz" bug is toast (really!).
  227.     ■ Self-induced divide overflow error fixed (stupid, stupid, stupid).
  228.     ■ Final line 64 is gone.
  229.     ■ Gusmod's and GTSR's memory allocation scheme changed.  Hopefully, this
  230.       will alleviate the problems.
  231.     ■ Simple interactive mode added.  Tagging and other neat features come
  232.       later.
  233.     ■ FLT4 support fixed.
  234.     ■ New, improved setup program.
  235.  
  236.  
  237. ──────────────────────────┐
  238. Source Code Availability: │
  239. ──────────────────────────┘
  240. As of Gusmod 2.11, full source code is available to the playback routines
  241. under assembly, C, and Pascal calls.  This will not be available immediately,
  242. but it will be available within two weeks of release.
  243.  
  244. The reason for the delay is that I want to verify that all of this is
  245. working properly before release.  To those who have contacted me thus far:
  246. I have your addresses and will get it to you as soon as possible.
  247.  
  248.  
  249.                                                 Joshua Jensen
  250.                                                 CyberStrike
  251.                                                 cstrike@gompers.gompers.edu
  252.  
  253.  
  254.                           ┌──────────────────┐
  255.                           │  Announcements:  │
  256.                           └──────────────────┘
  257.  
  258.     Watch for two upcoming Renaissance games that will be published
  259. through Epic MegaGames.  These will be very good, have full Gravis digital
  260. support (and Soundblaster/Soundblaster Pro digital support), and be out
  261. within the month.
  262.  
  263. ──────────────────────────────── Zone 66 ───────────────────────────────────────
  264.     The first is Zone 66.  Zone 66 is a 360-degree smooth-scrolling full-
  265. screen overhead 256-color VGA shoot-em-up.  It has utterly intense digital
  266. music and effects going on constantly, all mixed at 22khz.  It also takes
  267. advantage of the Ultraclick Removal System.  NOTE: Zone 66 IS OUT as of
  268. this release.
  269.     The Zone 66 files are named:
  270.         $zone66            - Main game
  271.         $zone66g           - Gravis UltraSound files
  272.  
  273.     Zone 66 may be obtained on the following FTP sites:
  274.         ftp.ulowell.edu               /msdos/Games/Epic
  275.         wuarchive.wustl.edu           /pub/MSDOS_UPLOADS/games
  276.  
  277.     and on:
  278.         Software Creations BBS        (508) 365-2359        2400 baud
  279.                                       (508) 365-9825        9600 baud
  280.                                       (508) 365-9668       14400 baud
  281.  
  282.  
  283. ────────────────────────────── CyberStrike ─────────────────────────────────────
  284.     The second is entitled CyberStrike, not after me... :)  It is similar
  285. to Smash TV.  Similar is the closest description to use.  The commercial
  286. version comes with 100 levels, with very fine detail in each one.  By using
  287. a new pattern-matching system, 180k of tiled graphics became 20.5k, never
  288. to be decompressed again.
  289.     Again, digital music and sound effects will accompany this one.
  290. CyberStrike will probably include the debut of the new music drivers that
  291. the Composer will use.  Virtually any sound card that supports digital output
  292. will be supported.
  293.     And, to top it all off, CyberStrike runs at a full 60 fps!
  294.  
  295. ───────────────────────── Protracker Studio 16 ─────────────────────────────────
  296.     Also, Renaissance will be releasing its 16-channel composer in the
  297. future.  The new format, which will hopefully become a standard, will be
  298. playable on a Gravis UltraSound, Soundblaster, Soundblaster Pro, and PAS-16.
  299. Except on the GUS, if all 16-channels are mixed at 22000hz, it takes
  300. approximately 20% of the system time of my 386-33.  4 channels take about 5%
  301. (this is about as fast as it gets, folks!).  The ability to port in MODs,
  302. STMs, 669s, and MIDs will be available.
  303.  
  304.  
  305.                             ┌──────────────┐
  306.                             │  Greetings:  │
  307.                             └──────────────┘
  308.  
  309.                        Raymond Bingham (wReam...)
  310.                     (Thanks for the grafix screen!)
  311.          (wReam Notes: Hi to all my buddies on alt.comics.lnh!)
  312.  
  313.                        The Rest of Renaissance :)
  314.  
  315.                               Future Crew
  316.            (Hey PSI, still got the UltraSound info for you.)
  317.  
  318.                               UltraForce
  319.  
  320.                                  Witan
  321.  
  322.                              Twilight Zone
  323.   (Hey, guys, just use the actual player.  The last one had problems!)
  324.          (Contact me and I'll send you the source to this one!)
  325.           (Besides, this one doesn't use the timer interrupt!)
  326.  
  327.                            The Phoney Coders
  328.              (Sorry I missed you guys last time.  Hi Zax!)
  329.  
  330.                         The Electromotive Force
  331.            (Hey, guys, just picked up a copy of PowerPlayer.)
  332.             (Awesome player...let's get the GUS support in.)
  333.  (You contact me or another member of Renaissance, I'll get you the code.)
  334.  
  335.                         Id Software - Jay Wilbur
  336.                                     - Paul Radek
  337.  
  338.                              Epic MegaGames
  339.  
  340.                                The Square
  341.                        (Yo, Otto, how ya doin'?)
  342.  
  343.                                 Cascada
  344.  
  345.                                 Yuri Lee
  346.  
  347.                                   DCE
  348.  
  349.                                  Triton
  350.  
  351.                                  Sonic
  352.  
  353.                                Space Pigs
  354.  
  355.                               Codeblasters
  356.  
  357.                              Access Denied
  358.  
  359.                                  Skull
  360.  
  361.                                  Epical
  362.  
  363.                                Paranoids
  364.  
  365.           All those who helped with the development of this...
  366.          (especially the Net people...you know who you are...)
  367.   (I'd like to list you all, but this doc would probably double in size!)
  368.                    (Thanks for all the beta testers!)
  369.